home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / os2 / nemo03.zip / NEMO.DOC < prev    next >
Text File  |  1994-06-22  |  14KB  |  431 lines
  1.  
  2.            Captain Nemo for OS/2 2.0
  3.          Version 0.3,  June 22nd, 1994
  4.  
  5.        Copyright (C) 1993, 1994 by Adam Mirowski
  6.  
  7. $Id: nemo.doc 1.37 94/06/22 02:36:11 ROOT_DOS Exp $
  8.  
  9. Introduction
  10. ------------
  11.  
  12. "Captain Nemo" is a text-mode shell program for OS/2.
  13. It tries to imitate the Norton Commander (R) for DOS
  14. v.2 as closely as possible while providing access to
  15. OS/2 specific features. I started writing it in March
  16. 1993 after buying NC for OS/2 and being very disappointed
  17. by it. At this point Nemo runs on several operating systems,
  18. including SVR4, SunOS, early versions of OS/2, and MS-DOS.
  19.  
  20. This version 0.3 is the third alpha release. Unlike the
  21. two previous ones, IT IS NO LONGER FREE. Even if it is
  22. still incomplete, buggy and full of checks that slow
  23. down execution and waste memory (while preventing most
  24. of disasters), it is very usable. If you use Captain
  25. Nemo regularly, you are required to pay a donation,
  26. 20 US dollars or 150 French franks, to the author.
  27.  
  28. Captain Nemo version 0.3 is distributed in the hope that
  29. it will be useful, but WITHOUT ANY WARRANTY; without even
  30. the implied warranty of MERCHANTABILITY or FITNESS FOR A
  31. PARTICULAR PURPOSE. You can use at your own risk, and
  32. report whatever problems you have encountered with it.
  33. You are free to copy this software ONLY if you include this
  34. document file with it. You may NOT charge anyone for a copy
  35. of this software other than a small copying fee. You may NOT
  36. include this software with any commercial software without
  37. the written consent of the author.
  38.  
  39. You can contact me either by writing an e-mail to:
  40.  
  41.     Adam Mirowski <mir@chorus.fr>
  42.  
  43. or sending a letter to:
  44.  
  45.     Adam Mirowski
  46.     Residence Les Cypres
  47.     10, rue Caruel de Saint-Martin
  48.     F-78150 Le Chesnay
  49.     FRANCE
  50.  
  51. You can phone me at +33 (1) 30-64-82-74 (business) or
  52. +33 (1) 39-54-27-34 (home). Please note that I live in
  53. the GMT+2 time zone.
  54.  
  55. For money transfers, sending US cash in an envelope is
  56. probably the most cost-effective way. In France, you
  57. may send checks. You might also use postal fund transfer
  58. methods, eg. International Money Orders.
  59.  
  60. Features
  61. --------
  62.  
  63. Since you are probably more interested in what is
  64. missing than in what is present, let's start by a
  65. non-features list.
  66.  
  67. Currently there is no:
  68.  
  69.     - <auto>    mouse support
  70.     - <auto>    full country information utilisation
  71.             (the  DD/MM/YY  HH:MM  format is used)
  72.  
  73. Modifications since the previous released versions are listed in the
  74. file 'whats-up.doc'.
  75.  
  76. These features are special to Captain Nemo:
  77.  
  78.     - <auto>    specific "long names" directory format for HPFS disks,
  79.             allowing up to 16 visible chars on 80 char wide
  80.             displays and up to 38 on 132 chars.
  81.             Also used in the logical naming mode.
  82.  
  83.     - <auto>    specific CD-ROM directory format, similar to the
  84.             "long names" HPFS format, except that the FAT case
  85.             convention is used: filenames are displayed in
  86.             lower case and directory names in upper case.
  87.  
  88.     - F12        Text mode task switcher
  89.  
  90.     - F9/O/O    Filenames on HPFS disks can be automatically displayed
  91.             using the FAT case convention.
  92.  
  93.     - F9/O/W    Hidden files can be omitted from directory panels.
  94.  
  95.     - F9/O/M    Mini-Status windows can show up to 38 or 64 first
  96.             chars of filenames, if needed.
  97.  
  98.     - Alt-F5    "logical file naming" mode in which files can be
  99.             identified and manipulated using arbitrary logical
  100.             names rather than hardware 8.3 MS-DOS names.
  101.             This makes FAT disks appear like HPFS ones,
  102.             and is also compatible with the Workplace Shell
  103.             naming (you can rename each other's objects using
  104.             alternatively NEMO and WPS).
  105.  
  106.     - ^F6        logical filename creation
  107.  
  108.     - <auto>    extended attributes support: EAs follow owning files
  109.             when those are copied or moved;
  110.  
  111.     - Alt-F6    132 column display support
  112.       F9/C/L
  113.  
  114.     - F9/O/R    screen-saver (didn't exist in NC v.2)
  115.     - <auto>    the extension file can have an unlimited length
  116.     - F9/O/V    the viewer can be set to an external executable
  117.     - <auto>    history elimination is case-sensitive
  118.     - grey*        inversion of file tags by mask (didn't exist until v.4)
  119.     - <auto>    unix-style text file support in the viewer
  120.     - F9/O/N    case-sensitive file sorting
  121.     - F9/O/T    reverse file sorting
  122.     - Alt-Enter    pasting of the current directory into command line
  123.  
  124.     - Shift-Enter    execution of current line preceeded by a user-defined
  125.             prefix, 'start ' by default. Also execution of
  126.             extension-defined commands, when pressing
  127.             Shift-Enter over filename.
  128.  
  129.     - !*        insertion of the list of currently selected files
  130.             into a command defined through the extension file
  131.             or the external editor/viewer call line.
  132.  
  133.     - F9/O/D    ^R can operate as in NC v.2 or as in NC v.3/v.4
  134.     - F5/F6/F8    Copy/move/delete operations can act on whole trees.
  135.             It is possible to copy empty directory trees along
  136.             with directory attributes, eg. C:\DESKTOP.
  137.  
  138.     - [disk:]...    "..." is interpreted as "..\.." in command-line
  139.             CD operations.
  140.  
  141.     - <auto>    Directory trees of CD-ROMs or read-only diskettes
  142.             are cached on the hard disk, so as to allow
  143.             operation of tree panels and NCD with these media
  144.  
  145. These features are shared with the reference program:
  146.  
  147.     - <auto>    a 100% NC for DOS v.2 look including colors;
  148.     - F9/[LR]/B    "Brief" and
  149.       F9/[LR]/L    "Long" directory formats for FAT disks;
  150.     - <auto>    fully functional command line editor, also in all
  151.             dialog boxes, including a "hysteresis" backscroll.
  152.     - <auto>    interaction between panels and command line,
  153.       ^Enter    including filename pasting
  154.     - <auto>    full and unlimited length extension file nemo.ext
  155.             with !, .!, !:, !\ and !! handling;
  156.     - X:   CD..    transparent capture of disk and directory changes
  157.       CD\  CD    and display performed using the command line.
  158.       CD <dir>    Error messages are native OS/2 messages for
  159.             full OS/2 CMD.EXE illusion;
  160.  
  161.     - INS         file tagging, preserved between shell command
  162.             execution and pane hiding;
  163.     - DEL        char deletion;
  164.     - grey-        file untagging by mask;
  165.     - grey+        file tagging by mask;
  166.     - Alt-...    file selecting by initials;
  167.     - arrows    operate differently according to the
  168.             type of the current pane, if any;
  169.     - HOME/END    operate  differently according to
  170.             the type of the current pane, if any;
  171.     - PageUp/Down    100% NC's funny logic;
  172.  
  173.     - F1        display help page;
  174.     - F2        nemo.mnu user menu, local and global;
  175.     - F3        viewer (can be disabled and set to an external
  176.             executable through Options/Viewer);
  177.     - F4        external editor (name can be set through a
  178.             Options/Editor);
  179.     - F5        file copying, individual and tagged, with
  180.             full wildcard support and full set of
  181.             informational and error messages;
  182.     - F6        file moving, directory renaming, with full
  183.             wildcard support and full set of informational
  184.             and error messages;
  185.     - F7        directory creation;
  186.     - F8        file/dir deletion, individual and tagged;
  187.     - F9        activate menu bar, turn on "Left" or "Right"
  188.             accordingly to the current panel;
  189.     - F10        quit
  190.  
  191.     - Alt-F1    disk selection
  192.     - Alt-F2    disk selection
  193.     - Alt-F3    view currently selected file using alternate viewer
  194.     - Alt-F4    edit currently selected file using alternate editor
  195.     - Alt-F5    Toggle usage of logical names
  196.     - Alt-F6    Toggle 132 column mode vs. 80 column mode
  197.     - Alt-F7    Find file
  198.     - Alt-F8    history box
  199.     - Alt-F9    43/50 lines
  200.     - Alt-F10    <not yet supported>
  201.  
  202.     - Shift-F1    <no action>
  203.     - Shift-F2    <no action>
  204.     - Shift-F3    arbitrary file viewing
  205.     - Shift-F4    arbitrary file editing
  206.     - Shift-F5    file copying/renaming by mask
  207.     - Shift-F6    file moving/renaming by mask
  208.     - Shift-F7    directory creation
  209.     - Shift-F8    file/dir deletion
  210.     - Shift-F9    save nemo.ini binary config file
  211.     - Shift-F10    <no action>
  212.  
  213.     - Ctrl-F1    turning left pane on/off
  214.     - Ctrl-F2    turning right pane on/off
  215.     - Ctrl-F3    <no action>
  216.     - Ctrl-F4    <no action>
  217.     - Ctrl-F5    <no action>
  218.     - Ctrl-F6    <no action>
  219.     - Ctrl-F7    <no action>
  220.     - Ctrl-F8    <no action>
  221.     - Ctrl-F9    <no action>
  222.     - Ctrl-F10    <no action>
  223.  
  224.     Ctrl-key combinations:
  225.     - ^A        word left
  226.     - ^B        keybar switching
  227.     - ^C        no action in command line, page down in editor
  228.     - ^D        one char forward
  229.     - ^E        previous history entry in command line, line up
  230.             in editor and in viewer
  231.     - ^F        word right
  232.     - ^G        delete char under cursor
  233.     - ^H        backspace
  234.     - ^I        switch to other panel if any
  235.     - ^J        paste pane selection into command line
  236.     - ^K        killing line end
  237.     - ^L        info panels
  238.     - ^M        execute command line
  239.     - ^N        open menu bar and select current panel menu
  240.     - ^O        panels on/off
  241.     - ^P        non-current pane switching
  242.     - ^Q        <no action>
  243.     - ^R        changing disk for current pane in command line,
  244.             page up in editor
  245.     - ^S        one char backward
  246.     - ^T        delete word right
  247.     - ^U        swap panels
  248.     - ^W        delete word left
  249.     - ^X        next history entry in command line, line down in editor
  250.             and in viewer
  251.     - ^Y        delete command line
  252.     - ^Z        <no action>
  253.     - ^Home        goto start of line
  254.     - ^End        goto end of line
  255.     - ^BS        delete word right (same funny semantics
  256.             for finding the char to stop on as in NC)
  257.  
  258.     - F9/[LR]/B    brief directory format
  259.     - F9/[LR]/F    full directory format
  260.     - F9/[LR]/I    information
  261.     - F9/[LR]/O    pane on/off switching
  262.     - F9/[LR]/[NXSMU]
  263.             all sorting options
  264.     - F9/[LR]/R    directory re-read
  265.     - F9/[LR]/D    drive selection
  266.  
  267.     - F9/F/H    help
  268.     - F9/F/U    user menu
  269.     - F9/F/V    view file
  270.     - F9/F/E    edit file
  271.     - F9/F/C    copy files
  272.     - F9/F/M    move files
  273.     - F9/F/M    make directory
  274.     - F9/F/D    delete files/directory
  275.     - F9/F/G    tag group of files by mask
  276.     - F9/F/N    untag group of files by mask
  277.     - F9/F/I    invert tagged status of files by mask
  278.     - F9/F/Q    quit NEMO
  279.  
  280.     - F9/C/H    history menu
  281.     - F9/C/E    EGA lines
  282.     - F9/C/S    swap panels
  283.     - F9/C/L    toggle 132 column mode
  284.     - F9/C/.    toggle logical name usage
  285.     - F9/C/P    panels on/off
  286.     - F9/C/C    compare directories (warning: like in NC, comparing is
  287.             only on existence/date/time. Not on size, attributes
  288.             nor EAs.)
  289.     - F9/C/M    menu file edit
  290.     - F9/C/X    extension file edit
  291.  
  292.     - F9/O/C    color dialog box
  293.     - F9/O/C/B    black and white display mode
  294.     - F9/O/C/C    color display mode
  295.     - F9/O/C/L    laptop display mode
  296.     - F9/O/A    auto menus on/off
  297.     - F9/O/P    path prompt switching vs. disk-only prompt
  298.     - F9/O/K    key bar on/off
  299.     - F9/O/F    full screen vs. half screen
  300.     - F9/O/I    ins moves down on/off
  301.     - F9/O/L    clock on/off
  302.     - F9/O/V    viewer selection
  303.     - F9/O/V/B    built-in viewer selection
  304.     - F9/O/V/E    external viewer selection and defining
  305.     - F9/O/E    editor selection
  306.     - F9/O/E/B    built-in editor selection
  307.     - F9/O/E/E    external editor selection and defining
  308.     - F9/O/R    screen-saver time-out adjusting
  309.     - F9/O/N    case-sensitive file sorting
  310.     - F9/O/T    reverse file sorting
  311.     - F9/O/H    Shift-Enter prefix definition
  312.     - F9/O/S    save setup
  313.  
  314. Known bugs
  315. ----------
  316. Known bugs are listed in the 'bugs.doc' file.
  317.  
  318. Remarks
  319. -------
  320. [1]  Nemo always uses DOS file selection mechanism, ie. the last dot
  321.      of a file name is considered as "the" dot and the other are seen
  322.      as ordinary chars.
  323.  
  324. [2]  OS/2 locks files and directories when used or current for a
  325.      process, so you cannot remove them, nor change their physical
  326.      or logical names.
  327.  
  328. [3]  Use ^ in logical names to obtain a newline effect on the WPS
  329.      desktop. You can even enter the ^ in the WPS, and as soon as
  330.      you validate the name change it will be transformed into a
  331.      visual newline.
  332.  
  333. [4]  Logical name support is still very uncomplete and somewhat
  334.      incoherent. Physical names are never updated when changing
  335.      logical ones. It is possible to have two files under the
  336.      same logical name, for example when copying a non-8.3 file
  337.      from an HPFS disk to a FAT disk and then back.
  338.  
  339. [5]  If you want an arbitrary number of screen lines (columns
  340.      must be either 80 or 132), execute the OS/2 "MODE" command
  341.      before or from within Nemo.
  342.  
  343. [6]  It is not possible to have 132 columns in a window. This is
  344.      a limitation of OS/2 windowed sessions.
  345.  
  346. [7]  A command file (.CMD) executed from within Nemo cannot modify
  347.      Nemo's current disk, nor directory. This is because Nemo executes
  348.      the .CMD file in a separate child process and child processes
  349.      don't communicate their current disk/directory to their parent
  350.      on exit. I don't plan to incorporate a .CMD file interpreter
  351.      into Nemo right now.
  352.  
  353.      For the same reason, it is not possible to use Nemo to change
  354.      the current disk or directory.
  355.  
  356. [9]  The initial message box will not be displayed if Nemo founds
  357.      a 'nemo.ini' setup file.
  358.  
  359. [10] The viewer uses different display algorithms when scrolling
  360.      backward and when scrolling forward. This may change the
  361.      appearance of lines which are over 78 characters. NC exhibits
  362.      similar differences.
  363.  
  364. [11] While the current disk and directory are saved in nemo.ini for
  365.      both panels, those for the current panel will be ignored at
  366.      startup time. Nemo's current panel will inherit the disk and
  367.      directory of the parent process.
  368.  
  369. [12] The provided setlname.exe utility can be used to attach a logical
  370.      name (.LONGNAME extended attribute) to a file.
  371.      
  372. Acknowledgements
  373. ----------------
  374. Benoit Poulot and Kai Uwe Rommel helped me a lot during the
  375. development.
  376.  
  377. The following people have provided bugs reports, ideas and
  378. (sometimes clinking) encouragements:
  379.  
  380.     Henk den Adel
  381.     Neil Aggarwal
  382.     Sébastien Bellefeuille
  383.         Martin Borstom
  384.     Egons Bush
  385.     Harry Bush
  386.     H. Choe
  387.     Andy Elkin
  388.         Oscar M. Fowler
  389.     Frans Goddijn
  390.     Simon Goland
  391.     Kordt Griepenkerl
  392.     Ralf Grohmann
  393.         Brian Grunkemeyer        
  394.     Anthony Guetmansky
  395.     Jon Hacker
  396.     Richard Johnston
  397.         Lars Jorgensen
  398.     Eduard Kappel
  399.     Jari Laaksonen
  400.     Christian Laubscher
  401.         Guylain Lavoie
  402.     Magnus Lövkvist
  403.         Leon Loo
  404.     Sanjay Madhavan
  405.     Francis Martin
  406.     James Mehl
  407.     Max Obkirchner
  408.     Jan Otterstedt
  409.         Matthias Rabe
  410.     Christian Rettner
  411.     Uwe Schlenther
  412.         Richard Stanton
  413.     Ronald Steinhoff
  414.     Morio Taneda
  415.     Andreas Tille
  416.         Eric Trepanier
  417.     Paul Tylich
  418.     Thomas Vandahl
  419.         Alfred Vink
  420.     William T. Warner, Jr.
  421.  
  422. Sorry if not all their ideas have find their way into this 0.3 release.
  423.  
  424. Paul Tylich is also the author of the alternate Captain Nemo icon.
  425.  
  426. Trademarks
  427. ----------
  428. "Norton Commander" (R) is a registered trademark of the
  429. Symantec Corporation.
  430.  
  431.